home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / programming / other / gui4cli / g4c / fsearch / fsearch.readme < prev    next >
Text File  |  1999-05-14  |  3KB  |  92 lines
  1. Short    : Pure CLI command to search files
  2. Uploader : dck@hol.gr (D. Keletsekis)
  3. Author   : dck@hol.gr (D. Keletsekis)
  4. Type     : util/cli
  5. Version  : 1.1
  6. Requires : WB 2.0+
  7.  
  8.  
  9. FSearch is a pure CLI command for Listing & Searching files.
  10.  
  11. Searching of files is fast and the template provided allows 
  12. you to accurately describe the types of files you are looking 
  13. for, thereby drastically reducing the scope of the search.
  14.  
  15. Fsearch has the following template :
  16.  
  17. ROOT/A/M        Where to start searching from.
  18.                 May be multiple root sources - with wild-cards
  19.                 ex : FSearch ram: dh0:mydir#? all
  20.                 List all files in all dirs in ram: and all
  21.                 files in all dirs matching dh0:mydir#?
  22.  
  23.         This option must be given. 
  24.         All others are optional.        
  25.  
  26. PAT/K           (string) File pattern to match
  27.                 Only files meeting this pattern will be searched
  28.                 ex : FSearch ram: pat=#?.info all
  29.                 List all info files in ram: or it's sub-dirs
  30.  
  31. TXT/K           (string) Text to search for.
  32.         If this option is not specified FSearch will act
  33.         like "list" and will not search the files.
  34.                 ex : FSearch ram: txt="my name" all
  35.         Note: By default the search is case-insensitive.
  36.  
  37. FROM/K          (date) Only search files FROM this date and up.
  38.         Dates must be written as dd-mm-yy.
  39.                 ex : FSearch ram: from=07-08-96
  40.  
  41. TO/K            (date) Only search files UP to this date
  42.  
  43. MIN/N/K         (number) Only search files more than MIN Kb.
  44.                 ex : FSearch ram: min=100 (look for files >= 100k)
  45.  
  46. MAX/N/K         (number) Only search files less than MAX Kb.
  47.  
  48. HEADER/K        (string) Only search files which have this header.
  49.                 The Header specification may contain wild cards.
  50.                 The first 100 bytes of the file will be loaded
  51.                 and checked against this Header.
  52.         ex : FSearch ram: header=FORM????ILBM#? all
  53.         will list all iff pictures in ram:
  54.  
  55. ALL/S           Recursively scan sub-directories
  56.  
  57. CS=CASESENSITIVE/S      
  58.         Make the search case-sensitive
  59.  
  60. V=VERBOSE/S     Print Line number & text of lines found.
  61.                 The default is to just print the file name on the
  62.                 first occurance of the TXT you're looking for.
  63.                 With this option all the matches and their 
  64.                 context will be displayed. If the line length is 
  65.         over 80 chars it will be clipped.
  66.  
  67. NOBIN/S         Do not check binary files. Up to 100 bytes of the
  68.                 file will be loaded and file will be skipped if
  69.         this header contains any non-ascii characters.
  70.  
  71. HL=HIGHLIGHT/S  Highlight the search results
  72.  
  73. INFO/S          Print file size/date/time next to it's name
  74.         No file paths are printed if this option is on.
  75.  
  76. NOPATH/S        Print only the file name - not the full path.
  77.  
  78.  
  79. A great looking, resizable, multitasking GUI is also 
  80. provided (preview included). The gui is independent of the 
  81. command itself, so you can use it (or not) as needed.
  82. To run the GUI you need the Gui4Cli program which you can 
  83. download from Aminet at dev/gui/Gui4Cli.lha
  84.  
  85. This program is FreeWare, but remains the Copyright of D.Keletsekis.
  86. No guarantees as to its performance or actions is made or implied.
  87. Use it at your own risk. 
  88.  
  89. D. Keletsekis
  90. November 1997
  91.  
  92.